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I. Motivation 


A teletype-compatible interface to UCSB's On-Line 
System (OLS) has been implemented ‘in accordance with the 
Telnet protocol adopted by the NWG. This re Telnet 
is responsive to connection requests directed by User 
Telnet's to socket number is host address 3. Although 
OLS is not a teletype system and although much of its 
power as a mathematical tool rests in its graphical 
display capabilities, enough of the System survives the 


Telnet transformation to justify such an implementation. 


Il. Limitations 


lIn this Telnet-style implementation of OLS, all 
curvilinear display generated by the user. on Levels Il 
and ITl, Real and Complex, is discarded by the System 
and hence not returned to the user through the Net. The 
same is true of the display of special, user-created 
characters. Although special characters may be con- 
structed and stored ,.their display will be suppressed, 
both during the process of construction and later when 
they are invoked trom the Type level. All other display 
generated by the System will be relayed to the user in- 


tact, in some cases with stylistic transformations having 


first been applied. For A Greek characters 

are displayed as lower-case a-z. ‘Ali such transfor- 
mations are described in detail in this document, 
Finally, those clements of the System (the operators 
which edit user programs are prime bun SE) which 
assume à fixed-sereen display device function abnor- 
mally in a Telnet GUNT Podicnts For such a device, tho 
System can 'remember' the position on the sereen of a 
previously displayed segment ot text and return to that 
position to, for example, underscore it. But wheh the 
'sereen' marches forward--relentiessly--through a con- 
tinuous melium, as it does with Telnet's virtual teletype, 
that kind of strategy fails. Jlence, the underscoring is 
not relocated, but rather appears on the current line, 
beginning in the next available character frame. 

OLS assumes, normally, that the user.is equipped 
with the svecially-designed double keyboard depicted in 
Figure 1. Conventions are defined in this document 
which enab:e a Telnet user to simulate that Revivoweds 
in particular, a means is provided for designating keys 


on the upper, or operator keyboard. 
Ll}. System Documentation 


This document has three purpos:s: 
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Figure 1. OLS Keyboard 


(lL). to describe the means by which a Telnet user 
simulates an OLS keyboard, 


(2) to describe the transformations applied to 
output generated by the System, and 


(3) to enumerate those aspects of the System which 


are unique to or behave differently for 
Network (Telnet) users. : 


[n particular, this document is not a user's manual 
for OLS. Such a manual is available and on file with 
the NIC. In addition, a copy should exist at each 
Network Site in its NIC collection; the user should 
consult his Station Agent. The document is titled 
‘UCSB On-Line System Manual! [NIC 5748]; its contents 
are current as of 1 Januàry 71. A revision to ‘the 
manual is currently in preparation and will be distri- 
buted wher available. In addition, tutorial manuals 
for two of the subsystems avails under OLS--MOLSF 
(Mathematically-Oriented Language Single-Precision 
Vloating-Foint) sd COL (Card Oriented Language)-- 
wil! soon be made E dei. The latter has already 
been published and is being transmitted to the NIC for 
distribution, while the former is Ronde completion. 
Docurentation of the third subsystem of OLS--NET- 
has already been distributed through the NIC as two 
REC's: 'Metwork On-Line Operators' [21 April 71, 
REC 121, NIC 5833| and 'A User Telret--Description of 


an Initial displementation' [9 August 71, RPC 206, NIC 


7176]. 


NET currently houses a sct of operators for system-call- 
level interaction with UCSB's NCP, a User Telnet, and an 
operator (invoked by ID on Level II) which returns the 
status of Network hosts. 

Staff members at the Computer Center E be happy 
to field questions about OLS from Network users. In 
particular, an OLS bonas feit is available for such 
purposes at (805) 961-4044 . Questions about OLS, 
including those specific to use of the System through 
the Network, may also be addressed to Jim White, UCSB's 
Technical Liaison, at (805) 961-3454 (if necessary, 
messages cin be left at the Computer Center Office, 


(805) 961-2261). 


IV. System Access 


The Network user is encouraged to explore the 
System and is invited to do so with the following 


accounting parameters: 


ltser Number: 196 
ld Nusber: 57372 
User Name: ARPA 
Problem Name: (affLliation)- (name) 
f in 16 characters or less 
(e.g., UCSB-WIIMI 


Such use of the System will not be billed. Production 


users are asked to establish their own accounts with the 


Computer Center ((805) 961-2261), the use of which will 
be billed in accordance with the then-current rate 


Structure. 


V, Software Structure 


This document is the description of a Network 
front-end to the On-Line System, logically distinct from 
OLS itself. This front-end is hereafter referred to as 
NETOLS.  NETOLS is always responsive to connection re- 
quests directed to socket 1. When contacted by a Network 
user, NETCLS performs the Network functions required to 
establish a duplex connection to him. The number of 
such duplex connections (and henee the number of Network 
users) is bounded by an assembly parameter whose current 
value is five. 

Before the Network connection is established, 

NETOLS secures for the user à port into OLS. Sixty- 

four such. ports exist and are shared by local, dial-up, 
and Network users. Should none be available, NETOLS will 
abort the connection sequence. 

Once a port has been secured and a Network connection 
established, NETOLS will effectively push the SYST key for 
the user by transmitting to OLS the 8-bit code representing 


that key. <A login sequence is thus initiated and the 


user is transmitted the lines: 


UCSB ON-LINE SYSTEM 
ENTER USER NUMBER 


to which he should respond with his user number. 
Soane at this point in time and continuing for 
the life of the Network connection, NETOLS's sole 
function is that of interpreter--interpreting input 
from the user and making it meaningful to OLS, and 
interpreting output from OLS and making it meaningful 
to the user (it is at this point, for example, that 
curvilinear and spectal-character display are dis- 
carded). 

When the user breaks his Neto connection to 
NETOLS, if he hasn't logged out of OLS already, 
NETOLS performs that function for him by pushing SYST 


DOWN, just as it pushed the initiai SYST. The OLS port 


acquired for the user is then released, and hence 
available for use by other users. It should be noted 
that the cser can log out of OLS ard back on again with- 
out the Network connection's DOE S since that 
action is transparent to NETOLS5, who attaches no special 


Sipniti¢caree to the key sequence which accomplishes it. 


VI. Virtual OLS keyboard 


A major function of NETOLS is to provide a mapping 
between elements of the Teinet character set and the 
keys on an OLS keyboard (Figure 1). The lower, or operand 
portion ot that keyboard is fairly sud represented, 
since ichs similar to a standard typewriter keyboard. 
Most of the keys on the lower kevboard are mapped on a 
one-for-one pases trom elements of xir Telnet character 
Set. Upper-case alphabetics are mapped into the alpha- 
betics, lower-case alphabetics into the Greek characters, 
numerics into numerics, and a miscellany of punctuation 
into itself. All such one-for-one mappings are depicted 


in Figure 2. A line of that figure reads as follows: 


For targ 
The key labeled '>' (meaning logical not) 
on the lower portion of an OLS keyboard is 


struck by causing the user's User Telnet to 
transmit '~' (tilde). 


Those lower-keyboard keys not listed in Figure 2, 
and all the keys on the upper-kevboard (hereafter referred 
to collectively as non-standard keys), arc represented 
by the Telnet uscr in the following manner. For each 
such key, a character string has been defined; the string 


is called the name of the key. In most casos, the name 


[Po] 


of a key is identical to its label in Figure 1. The 
name of the SIN key, for example, is 'SIN' (in the 

On-Line System User's Manual, upper-keyboard keys are 
denoted by underscoring their labels, to dastagai 


for example, the key SIN from the three keys 'SIN'). 


Every non-standard key on the OLS keyboard 

is struck by typing its name (or any unique 
abbreviation thercof), preceded by a special 
prefix character and followed by a space. 


NETOLS intercepts the prefix, name, and space and from 
them generates a single, 8-bit code which it forwards 
to OLS. 

The default prefix character is semi-colon (';'), 
chosen simply because for touch typists it's one of the 
home keys. The prefix can be changed by the user to 
any character listed in Figure 2. The procedure for so 
doing is described in Section VII-B. To send the prefix 
character through NETOLS to OLS, type it twice in suc- 
cession. "hus, if the default prefix is in e rab 
';;' is mapped into a single semi-colon and relayed to 

The nimes of all non-standard keys are Listed in 


ligure 3. A line of that figure reads as follows: 


For SIN: 


The key denoted SIN in the OLS User's Manual 
(the trigonometric function sinc) is named 
'SIN', and hence is struck by typing 'SIN', 
preceded by the prefix and followed by a 
space. 


Assuming, then, that the default prefix ';' is in 
effect, SIN is struck by typing ';5IN_' ('_' is used 
here and in following examples to dote a space). 
Furthermore, if the user chooses, he may abbreviate 
that as "pol ', since the key desired remains uniquely 
-identified. kartke abbreviation (to ';S ') is un- 
satisfactory and hence disallowed since the single 
character 'S' is insufficient to distinguish between 
a number of keys whose names begin.with that character. 
Key names may be typed by the user in either upper- 
or lower-case. 
As cach character of a non-standard key's name is 
typed by the user, NETOLS consults its table of key names. 
If the character string so far Specified cannot possibly lead to 
a valid name, tho most recent character is ignored ('?' echoed). 
Hence, typing ';SJIN ' will be accepted as SIN, the 
Erroneous 'J' being ignored (and,a DUE OM mark echoed), 
and the subsequent TIN. ' accepted. If when the tere 
minating spasce is typed, no single key is uniquely 
identified a '?' is echoed and the space ignored. ‘Thus 


"tie Lot wi. 1 be recognized as SIN; the first space is 
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Logical Or 
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Carriage Return 
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ligure 2. 
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Decimal Digits 
UC Alphabetics 
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Multiply 


Add + 
Subtract - 
Carriage Return . 
Divide / 
Level O 0 
Level 1 l 
Level Ul 2 
Level Ii] 3 
Level LV 4 
Level V 5 
Level VI 6 
Level Vil 7 

Add ADD 
Argument ARG 
Are Tangent ATAN 
Backspace BACK 
Case CASE 
Cent Sign CENT 
Clear Tab CLEAR 
Complex CMPLX 
Contract CON 
Conjugate CONJ 
Convolve CONV 
Cosinc COS 
Context CTX 
Delta DEL 
Forward Difference DIFF 
Display DISPLAY 
Divide DIV 
Down DOWN 
Enlarge ENL 
Enter ENTER 
Erase ERASE 
Escape ESCAPE 
Evaluate EVAL 
Exponentiate EXP. 


FULLDUPLEX 
HALFDUPLEX 
HELP 


NHTOLS Command 
NETOLS Command 
NETOLS Command 


Identity l ID 

Invert £ INV 
Line Feed Down LEDN 
Line Feed Up LEUP 


Figure 2. Keys Represented As Strings 
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Load 
Logarithm 
NETOLS Command 
Left Shift 
Maximum 

Modulus 
Multiply 

Negate 

Logical Not 
Logical Ur 
Predicate 
NETOLS Command 
Running Product 
Point 

Power 

Real 

Reflect 

Repeat 

Reset 

Carriage Return 
Right Shift 
Superscript 0-9 
Select 

Set Tab 

NETOLS Command 
Sine 

Sort 

Square 

Square Root 
NETOLS Command 
Store 
Substitute 
Subtract 
Running Sum 
System 

Test 

Type 

NETOLS Command 
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LOGOUT 


LS 


MAX 
MOD 
MULT 
NEG 
NOT 
OR 
PRED 
PREFIX 
PROD 

PT 

PWR 

REAL 
REFL 
REPT 
RESET 
RETURN 
RS 

S0-S9 
SELECT 
SET 
SIEIUT 
SIN 

SORT 

SQ 

SQRT 
STATE 
STORE 
SUB 
SUBTRACT 
SUM 

SYST 
TEST 
TYPE 
UNSHIFT 
UP 
USER 


Keys Represented As Strings 
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. 6. 


Alternate names lor ©, @, ©, RETURN, and © 


are 'MULT', 'ADD', 'SUBTRACT', 'HRETURN', and 
"DIV', respectively. RETURN can also be 
represented as the single character CR 
(carriage return), as indicated in Figure 2. 


An alternate name for € is '«'. 
Alternates for BACK are the single characters 


BS (backspace) and DEL (rubout), as indicated 
2 


in ligure 2. 
An alternate namo for @ is 'DIV'. 
NETOLS commands are explained in Section VII. 


Án alternate name for (O; is 'MULT'. 


An alternate for !'—' is the single character 
"v (tilde), us indicated in ligure 2. 


Án alternate lor ']* is the single character 


ux (vertical line), as indicated in ligure 2. 


An alternate name for RETURN is !'.!'. RETURN 
can also be represented as the single charact 
CR (carriage return), as indicated in Figure 


An alternate name for © is '-'. 


Notes for ligure 3. 
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ignored (and a '?' echoed, iudicdbigg that 'S' alone is 
ambiguous). 

At any point in the entry of a key name, either 
Altmode (ESC) or !'?' may be typed by the user.  NETOLS 
will then determine whether a key has been uniquely 
specificd by the characters already typed. If so, it 
will echo the remaining characters of the key's name, 
and consider them entered by the user. <A subsequent 
space from the user will cause the indicated key to be 
pushed. If no single key is uniquely specified, NETOLS 
will echo Bel, causing a Bed to be rung on many terminals. 
More of the key name is then peeved from the user. 

If after at least one character of the key’ name 
has been entered by the user and accepted by NETOLS 
(and before the terminating space is typed) the prefix 
is typed a second time, all alread; entered characters 
of the nare are discarded by NETOLS. Thus ';CO;SIN ' is 
interpreted as SIN. If a carriage eatin is typed in 
the sume context, the initial pref.x will also be dis- 
carded., lence, “COGS! Ae denotes carriage return) 


is interpreted as the lower-keyboaid key 'S'. 
VII. NETOLS Comnands 


A number of commands to NETOLS are defined and 
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all are described in this section. ‘The format for each 
Such command is the same as that for non-standard keys, 
aud hence the command keywords are included in ligure 3. 
All of the conventions of Section Vl apply as stem to 

the entry of commands. The user should understand, 
however, that such commands are processed bv NETOLS, 

not OLS, and that they are defined only for Network users 


of OLS, 


A. HELP 

The HELP command (invoked with ';HELP_' if ';'! 
is the prefix) reproduces for the user the third column 
of Figure 3; the names of all non-standard keys and the 
keywords for all defined NETOLS commands are listed in 


their collating sequence on the user's virtual teletype. 
B. PREFIX 


Issuing the PREFIX command causes the next character 
typed to become tho prefix, provided it is one of those 


listed in Fipure 2. Consequently, "SPREFIX @' makes '@! 


the prefix, '@PREFIX_ ;' restores the default situation. 
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C. SHIFT and UNSHIFT 


The SHIFT command causes a perturbation of lines 
2 and 3 of ligure 2. After SIIPT is issued, all sub- 
sequent upper-case alphabetics nae eae into the Greek 
characters (rather than into the alphabetics), and lower- 
case alphabetics into alphabetics (rather than into the 
Greek characters). This convention change may be found 
convenient if the user's User Telnet sends lower-case 
alphubetics by default, and requires, for example, that 
a init key be held down to send upper-case characters. 


The UNSIIIFT command nullifics the effect of SHIFT. 
D. FULLDUPLEX and HALFDUPLEX 

Issuing the FULLDUPLEX command causes all sub- 
sequent characters typed by the usir to be echoed by 
NETOLS.  IALLDUPLEX nullifies tho cffect of TFULLDUPLEX, 
disabling echo by NETOLS. Half-duplex is the default 
situation. 


E. STATE 


The STATE command causes the current prefix, 


the mode of operation ('HALEDUPLEX' or 'FULLDUPLEX'), 
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and the case convention ('SHIFT IS ON' or 'SIIIFT IS OFF‘) 
to be displayed on the user's. virtual teletype in the 


following form: 


PREFIX 1S ; 
HALF DUPLEX 
SHIFT IS OFF 


F. LOGOUT 


Issuing the LOGOUT command causes the user to be 
logged out of OLS (i.e., SYST DOWN to be pushed) and 
his Networ: connection to NETOLS to be broken. About 


three seconds elapse between the two events. 


VIII. OLS Display 


NETOL3 suppresses all but alphameric display 
before it reaches the user. E E te display is 
mapped into the Telnet character set according to 
Figures 4 and 5. Figure 4 lists all those OLS display 
characters which have one-for-one mappings. A line of 


that figure reads as follows: 


For !'7!:; 
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The character logical not, displayed as '™! 
on an OLS.terminal, is represented in Telnet 
as fw! (tilde). 


Alphabetics are mapped into upper-case alphabetics 
and Greek characters into lower-case alphabetics. 
Numerics are mapped into numerics, and a miscellany 
of punctuation into itself. In addition a number of 
carriage control characters are appropriately mapped-- 
line feed down into LF, TAB into HT, BACK into BS, etc.; 
line feed up is suppressed. ERASE is ropresented,as Bel. 
Figure 5 lists those OLS display characters which 
are nappe ined strings of Telnet characters. In most 
cases, these character oer tugs are stylistic representa- 
tions of characters peculiar to OLS. For example, the 
ADD key is normally displayed in List mode as '@'. 


In this Telnet implementation, '(*)' is an attempt to 


represent that graphic. Superscripts are represented 
as underscored numerics. Carriage return is represented 
as CR LF. No attempt is made to effectively represent 


RS which, on an OLS display device, repositions the 
beam to the upper left corner of the screen; it is made 
equivalent to carriage return. 


IX. Instructing a User Telnet 


For local users, all echoing that's done at all 
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Decimal Digits 
UC Alphabetics 
LC Alphabetics 
Exclamation Mark 
Plus Sign 
Underscore 

Minus Sign 


. Commercial At 


Slant 
Number Sign 
Apostrophe 
Ampersand 
Dollar Sign 
Asterisk 
Percent 
Equal Sign 
Horiz. Tab. 
Colon 
Semi-Colon 
Left Bracket 
Right Bracket 
Left Parenthesis 
Right Parenthesis 
Less Than 
Greater Than 
Comma 

Period 

Quotation Marks 
Question Mark 
Tilde 

Vertical Line 
Backspace 

Space 
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Line: Feed (TJ) 
Underscore 
Upper-case X 
Underscore 
Space 


Bell (fG) 


One-for-One Mappings 


To (OLS 
Display Explanation) 


Post List 
List Mode Add 
List Mode Subtract 
List Mode Multiply 
List Mode Divide 
List Carriage Return 
RETURN Carriage Return 
RS Reset to Upper Left 
¢ Cent Sign 
0-9 Superscript 0-9 


Figure 5. Characters Which Map Into Strings 
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is done by OLS; the terminal never echos. In general, 
OLS does not echo the user's input. There are exceptions 
to this rule, but they are relatively few in number and 
occur primarily on the SYST level. In particular, upper 
keyboard keys are never echoed except in List mode. The 
Network user is advised to instruct his Telnet to operate 
in full-duplex mode, i.e. to echo nothing. The 
FULLDUPLEX command provided by NETOLS is provided because 
is can be provided easily, but its use is not recom- 
mended. 

OLS is meant to be used in character-at-a-time 
mode, and the user should so imnstrict his User Telnet. 
For those users provided with only a line-at-a-time 
mode, the end-of-line character shculd not be transmitted 
to NETOLS. 

NETOLS flushes without comment all Telnet control 
characters it detects in the input stream. Characters 
in the Telnet character set which have no meaning to 
NETOLS are echoed as '?' and discarded. Exceptions are 


LF (line feed) and NUL, which are flushed without comment. 


X. Examples 


A. Logon 


The dialogue which logs a user onto OLS, assuming 
the user number of Section 1V, is as follows: 
TELNET ENTRY OLS QUERY/RESPONSE 


UCSB ON-LINE SYSTEM 
ENTER USER NUMBER (196) 


196% ID NUMBER= 
57372% USER NAME= (ARPA) 
ARPAS JOB NAME= (UCSB-WHITE) 
UCSB-WI!IITE* AUTOSAVE CODE= integer 
MOLSFE $ LOAD (MOLSF) 


FILE LOADED 


In this and succeeding examples, '$' denotes CR (carriage 
return). <sntries echoed by OLS are enclosed in parentheses 
above. The user should substitute for 'UCSB-WHITE' his 

own affiliation and name. The procedure above loads the 
math bulbs oto of OLS. To load instead either COL or 

NET, substitute its name for 'MOLSF'. To. load a different 


subsystem (say COL) after logging in: 


TELNET ENTRY OLS QUERY/RESPONSE 
;SYST_ WORK AREAS UPDATED 
;LOAD COLS LOAD (COL) 


FILE LOADED 


Again, ' ' denotes a space, not an underscore. 
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B. NEWTON-RAPHSON SQUARE ROOT APPROXIMATION 


A simple user program can be constructed to 
approximate the square root of a number N using the 
Newton-Raphson iteration procedure which derives the 


th 


(k+1)t? approximation from the k by the following 


"algorithm: 


X417 (x, *N/x,)/2 


The following entries construct the user program: 


;LIST ;TYPE $ ENTER N 

;1_ ;REAL ;LOAD ;ENTER ;STORE N 

;TYPE % ENTER FIRST GUESS 

;l  ;LOAD ;ENTER ;STORE X 

;TYPE % # OF ITERATIONS? 

;0 ;LOAD ;ENTER ;STORE N 

jl ;REPT_(;LOAD_N ;/_ X ;+ X 3 2 
;STORE X ;DISP $)N$ ;USER ;SQRT_ 

ALIST STORES USEN I = SORT 


To display the user program, enter: 


FUSER $3DISP 2SQRT 
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When executed, the program obtains from the user the 
number N whose square root is sought, an initial guess, 
ana the number of iterations to be performed. The 
program then computes and displays the result of each 


iteration, and then calls itself, permitting a second 


square root to be computed. The program is executed as 
follows: 
TELNET ENTRY OLS QUERY/RESPONSE 
;USER ;1 ;SQRT ENTER N 
S ENTER ENTER FIRST “GUESS 
1 ;ENTER_ # OF ITERATIONS? 
4 ;ENTER_ 2; +00 
1.75 *00 
1.73214+00 
1.73205*00 
ENTER N 
etc. 


C. Remote Job Entry 


A file of card images can be constructed with the 
help of th2 COL subsystem of. OLS ard submitted as a 
batch job. Assuming COL has been loaded, the following 
entries coistruct a card file which invokes the Fortran 


compiler: 
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;2_ f//jobname JOB (aceth name, > v, T) STORE 


WT D ; STORE _ 
//FORT.SYSIN DD * ; STORE _ 
source-statement-1] ;STORE- 
"m STORE | 

To display the completed file, type: 
1:9 4DISP 4 

To submit the file, type: 
;4 ;SUB 3 

To watch for it in execution, type: 


;DISP_J%%%. 


When execution is complete, 'printed'' output can be 


retrieved with the following dialosue: 


i 


TELNET ENTRY 


;CMPLX ;LOAD _ 
2314% ` 
MVT180% 
RJEOUT% 
jobname% 


The output can then be 


OLS QUERY/RESPONSE 


UNIT= (2314) 
VOL=SER= (MVT180) 
DSNAME= (RJEOUT) 
MEMBER= (jobname) 
NOW LOADING 
FILE LOADED 


examined by entering: 
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